home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / syncrnet / sbe_122.zip / SBBSECHO.DOC < prev    next >
Text File  |  1996-02-15  |  38KB  |  1,298 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                     SBBSecho
  21.                   Version 1.22
  22.                 Updated 02/15/96
  23.  
  24.            FidoNet Packet Tosser for Synchronet BBS Version 2
  25.  
  26.             Copyright 1995 Digital Dynamics
  27.  
  28.                                   PO Box 501
  29.                              Yorba Linda, CA 92686
  30.  
  31.          Voice: 714-529-6328   BBS: 714-529-9525 V.32/V.32bis
  32.            FAX: 714-529-9721        714-529-9547 V.FC
  33.                   Fido: 1:103/705      ftp: netcom.com /pub/sb/sbbs
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Table of Contents
  59. =================
  60.  
  61. Introduction.............................................................3
  62. Terminology..............................................................4
  63. Installation.............................................................6
  64. AREAS.BBS Format.........................................................7
  65. Configuration............................................................8
  66. Running SBBSecho........................................................20
  67. Command Line Switches...................................................21
  68. Area Manager Remote Commands............................................22
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113. _______________________________________________________________________________
  114. SBBSecho                              2                                Contents
  115.  
  116.  
  117. Introduction
  118. ============
  119.  
  120. SBBSecho is a full-blown FTN echomail program (tosser/scanner) for Synchronet
  121. BBS version 2. SBBSecho is level III implementation of the SMB v2.00
  122. specification including support for HyperAllocated and LZH compressed message
  123. bases.
  124.  
  125. It is intended to replace FTSC-1 (*.MSG) compatible echomail programs (GEcho,
  126. Squish, FastEcho, Alexi/Mail, etc.) and SBBSFIDO with a single program
  127. incorporating the standard features of echomail programs without the .MSG
  128. phase (consuming disk space and time).
  129.  
  130. You will not need to use SBBSFIDO (*.MSG import/export utility for Synchronet)
  131. or any echomail programs after you have installed SBBSecho.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172. _______________________________________________________________________________
  173. SBBSecho                              3                            Introduction
  174.  
  175.  
  176. Terminology
  177. ============
  178.  
  179. FTN
  180. ~~~
  181. FidoNet Technology Network: Any network using FidoNet standards for addressing,
  182. mail packets, mail sessions, node lists, etc.
  183.  
  184. Zones, Nets, Nodes, and Points?
  185. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  186. FTN node addresses are like phone numbers, they are made up of multiple
  187. components (four to be exact). The components are: zone, net, node, and point.
  188. Each component is specified by a decimal (base-10) number, separated by symbols
  189. (no spaces):
  190.  
  191.     Zone:Net/Node.Point
  192.  
  193. The zone represents the continent (if FidoNet) or the network number (if other
  194. FTN network). All FidoNet nodes in North America have a zone 1 address. When
  195. the zone is specified in an address, it is the first component and must be
  196. followed by a colon. If the zone is not present in an address, the local
  197. system's zone is assumed.
  198.  
  199. The net represents the network number of the FTN node. Duplicate net numbers
  200. may exist between zones. If the net number is not present, the local system's
  201. net is assumed.
  202.  
  203. The node number specifies an exact FTN node within a network. The node number
  204. is the only required element of an FTN node address.
  205.  
  206. The point is an optional component which specifies a sub-node that does not
  207. directly receive mail and is also not listed in the main FTN node list, but
  208. instead gets all its mail from its boss-node (zone:net/node.0). When the point
  209. is not specified, 0 (zero) is assumed (i.e. 1:2/3 and 1:2/3.0 are identical)
  210. which indicates the system is not a point node address.
  211.  
  212. A 2D (2 dimensional) address refers to an FTN address containing just the
  213. net and node numbers (i.e. 103/705).
  214.  
  215. A 3D (3 dimensional) address refers to an FTN address containing the zone,
  216. net, and node numbers (i.e. 1:103/705), specifically excluding the point number
  217. if it exists.
  218.  
  219. A 4D (4 dimensional) address refers to an FTN address containing the zone,
  220. net, node, and optional point numbers (i.e. 1:103/705.1).
  221.  
  222. A 5D (5 dimensional) address refers to an FTN address consisting of a standard
  223. 3D or 4D address with an appended "@domain" (i.e. 1:103/705@fidonet.org).
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231. _______________________________________________________________________________
  232. SBBSecho                              4                             Terminology
  233.  
  234.  
  235. Attach or FLO Mailer?
  236. ~~~~~~~~~~~~~~~~~~~~~
  237. If you are using FrontDoor, InterMail, D'bridge, SEAdog, Dutchie, or any other
  238. ArcMail *.MSG attach-style mailer, you are using what we will refer to as an
  239. "Attach Mailer".
  240.  
  241. If you are using BinkleyTerm, Portal of Power, or any other FLO/CLO/HLO/DLO
  242. style mailer, you are using what we will refer to as a "FLO Mailer".
  243.  
  244. Both types are supported equally by SBBSecho.
  245.  
  246. NetMail
  247. ~~~~~~~
  248. Point-to-point (usually person-to-person) direct or routed messages.
  249.  
  250. EchoMail
  251. ~~~~~~~~
  252. Group or conference messages of a particular subject matter. Usually
  253. distributed on a regional or continental (e.g. FidoNet Zone 1 backbone) scale.
  254. FTN style echomail areas have a unique area tag (name) associated with them to
  255. distinguish each area from the others.
  256.  
  257. Packet
  258. ~~~~~~
  259. An FTN packet is a group of one or more messages contained in a single
  260. uncompressed file. Packets may contain echomail and/or netmail messages.
  261. Packets usually have a .PKT extension, although outbound NetMail packets for
  262. FLO Mailers will have .?UT extensions (where ? is either O, C, D, or H). The
  263. first eight characters of the filename may be anything, but are usually decimal
  264. digits representing the date and time the packet was created. SBBSecho creates
  265. temporary outbound packet files with a .PK_ extension and then renames them to
  266. .PKT when they're completed. If you find any .PK_ files in your outbound
  267. directory, don't worry. SBBSecho will find them the next time it is run and
  268. continue packing them and sending them on their way.
  269.  
  270. Bundle
  271. ~~~~~~
  272. An FTN bundle is a single file archive of one or more (usually compressed)
  273. packets. Bundles will have file extensions where the first two characters
  274. represent the day of the week the bundle was created (MO, TU, WE, TH, FR, SA,
  275. and SU) and the third character of the extension is a number or letter. The
  276. first eight characters of the filename may be anything, but are usually
  277. hexadecimal digits representing the FTN node address (or relative address) of
  278. the system that created the bundle. SBBSecho changes the file extension of bad
  279. inbound bundles to .MO_, .MO-, or .MO.
  280.  
  281. Areafix/Area Manager
  282. ~~~~~~~~~~~~~~~~~~~~
  283. Areafix is a synonym for area manager (the very first FTN area manager
  284. program was called AreaFix). Area manager capabilities (remote adding/removing
  285. of areas, changing compression type, etc) are built into SBBSecho, so therefore
  286. no external area manager program is required. If you are not an FTN hub, then
  287. the area manager portion of SBBSecho will probably not get any use on your
  288. system.
  289.  
  290. _______________________________________________________________________________
  291. SBBSecho                              5                             Terminology
  292.  
  293.  
  294. Installation
  295. ============
  296.  
  297. To begin, copy the SBBSECHO.EXE, ECHOCFG.EXE, and AREAMGR.HLP files into your
  298. Synchronet EXEC directory (usually C:\SBBS\EXEC), copy the SBBSECHO.CFG file
  299. into your Synchronet CTRL directory (usually C:\SBBS\CTRL), and copy the
  300. SBBSECHO.DOC file into your Synchronet DOCS directory (usually C:\SBBS\DOCS).
  301.  
  302. If you plan on using the 32-bit DOS, OS/2, or Windows 95/NT version of
  303. SBBSecho, you will need to put the appropriate SBBSECHO.EXE file into your
  304. Synchronet EXEC directory (unzip OS2.ZIP for the OS/2 version, DOS4G.ZIP for
  305. the 32-bit DOS version, or WIN32.ZIP for the Windows 95/NT version). If
  306. you get memory allocation errors running the 16-bit DOS version or desire
  307. improved performance, you will want to run one of the 32-bit versions.
  308.  
  309. Add the SBBSCTRL and SBBSNODE environment variables to your AUTOEXEC.BAT.
  310. Example:
  311.  
  312. SET SBBSCTRL=C:\SBBS\CTRL
  313. SET SBBSNODE=C:\SBBS\NODE1
  314.  
  315. Note: The node number used for the SBBSNODE environment variable is not
  316.       important, use your NODE1 directory.
  317.  
  318. These environment variables must be present for SBBSECHO and ECHOCFG to
  319. function correctly. Type "SET" at the DOS prompt to be sure they are listed
  320. correctly.
  321.  
  322. You will also need to modify your existing MAILER.BAT (or FDRUN.BAT, IMRUN.BAT,
  323. etc) file to accomodate the use of SBBSecho, or replace it with the MAILER.BAT
  324. included with SBBSecho. If this is your first time setting up FidoNet, you will
  325. not currently have a MAILER.BAT file set up, so use the one that is included
  326. and modify it so that it reflects the proper drive letters and directories.
  327.  
  328. Next, SBBSecho expects to find the file AREAS.BBS in your Synchronet DATA
  329. directory (usually C:\SBBS\DATA) unless you have overridden the default name
  330. and/or location using the ECHOCFG program.  The format of this file is very
  331. similar to the standard AREAS.BBS (which many echomail programs use, or can
  332. at least export their native area file to this format - i.e. GEcho's GSETUP).
  333.  
  334. SCFG can also export your sub-boards to AREAS.BBS, but you're probably better
  335. off modifying the AREAS.BBS file you're already using (if you are) or
  336. converting your current echomail program's area file to AREAS.BBS. This is
  337. because SCFG assumes the sub-board short name will be the same as the area's
  338. tag (as shown in your echo list), but this may not always be the case - unless
  339. you imported an AREAS.BBS or FIDONET.NA file into SCFG to begin with).
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349. _______________________________________________________________________________
  350. SBBSecho                              6                     Installing SBBSecho
  351.  
  352.  
  353. AREAS.BBS Format
  354. ================
  355.  
  356. Lines beginning with a semicolon (;) are considered comments, and are ignored.
  357.  
  358. Each line is in the following format:
  359.  
  360. CODE    TAG    UPLINKS
  361.  
  362. Where:
  363.     CODE is the internal code of the sub-board. Any unrecognized internal
  364.         codes are considered "Passthru" (not imported to your BBS).
  365.  
  366.     TAG is the FidoNet tag as shown in your echo list (i.e. FIDONET.NA).
  367.         If this is '*', then it will be considered a "badecho" area
  368.         and will receive all messages for areas not otherwise specified
  369.         in this file.
  370.  
  371.     UPLINKS is a list of FidoNet addresses which you wish to export mail
  372.         to. At the very least, your hub's address should be listed
  373.         here. Your address should NOT be listed here. If multiple
  374.         addresses are specified, you should specify the full 3D address
  375.         for each.
  376.  
  377. AREAS.BBS Example:
  378.  
  379. SBBS        SYNCHRONET    1:3615/50
  380. SYNCDATA    SYNCDATA    1:3615/50
  381. SYNC_SYS    SYNC_SYSOPS    1:3615/50
  382.  
  383. The amount of spacing between each element in the line is not important. Each
  384. line can be up to 1000 characters in length.
  385.  
  386. So if your OLD AREAS.BBS file is in .MSG format (for example):
  387.  
  388. C:\FD\ECHO\SBBS     SYNCHRONET    1:3615/50
  389.  
  390. It must be changed to match the example given above!
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408. _______________________________________________________________________________
  409. SBBSecho                              7                        AREAS.BBS Format
  410.  
  411.  
  412. Configuration
  413. =============
  414.  
  415. In order to set up SBBSecho for your system you must run the included ECHOCFG
  416. program. It should already be located in your EXEC directory. You may want to
  417. put your EXEC directory in your DOS search path so you can execute SBBSECHO and
  418. ECHOCFG from any drive and directory on your system.
  419.  
  420. Multiple configuration files can be used (but isn't usually required) for
  421. multi-mailer systems. The default configuration filename is SBBSECHO.CFG
  422. located in your Synchronet CTRL directory. You can override this by specifying
  423. the name and location of the configuration file on the SBBSECHO and ECHOCFG
  424. command lines. Example:
  425.  
  426. ECHOCFG D:\ECHO1.CFG
  427. SBBSECHO D:\ECHO1.CFG
  428.  
  429. If you do not specify a configuration file, ECHOCFG and SBBSECHO will use
  430. SBBSECHO.CFG located in your Synchronet CTRL directory.
  431.  
  432. Upon running ECHOCFG you will be brought to the main menu of the configuration
  433. program. The path and filename of the configuration file being modified will
  434. appear at the top of the menu. Following are screen captures of available menus
  435. within the configuration program and an explanation of the options contained on
  436. each of them.
  437.  
  438.           ╔[■][?]════════════════════════════════════════════╗
  439.           ║        C:\SBBS\CTRL\SBBSECHO.CFG         ║
  440.           ╠══════════════════════════════════════════════════╣
  441.           ║ │Mailer Type            FrontDoor/Attach ║
  442.           ║ │Maximum Packet Size        250K         ║
  443.           ║ │Maximum Bundle Size        250K         ║
  444.           ║ │Areafix Failure Notification    User #1      ║
  445.           ║ │Registration Number        UNREGISTERED     ║
  446.           ║ │Nodes...                     ║
  447.           ║ │Paths...                     ║
  448.           ║ │Log Options...                  ║
  449.           ║ │Toggle Options...                 ║
  450.           ║ │Archive Programs...                 ║
  451.           ║ │Additional Echo Lists...             ║
  452.           ╚══════════════════════════════════════════════════╝
  453.  
  454. Mailer Type:
  455.     Selecting this option will toggle between the mailer types supported
  456.     by SBBSecho, either FrontDoor (message attach) type mailers or Binkley
  457.     (FLO file) type mailers.  Choose the one that matches your front-end
  458.     mailer type.
  459.  
  460. Maximum Packet Size:
  461.     This option allows you to set the maximum size of each outgoing
  462.     echomail packet.
  463.  
  464.  
  465.  
  466.  
  467. _______________________________________________________________________________
  468. SBBSecho                              8                    Configuring SBBSecho
  469.  
  470.  
  471. Maximum Bundle Size:
  472.     Mail packets are normally packed into what are called "bundles" (unless
  473.     a node is set up to receive uncompressed mail packets).  This option
  474.     allows you to specify the maximum size of each outgoing mail bundle.
  475.  
  476. Areafix Failure Notification:
  477.     This is the user number of the person where notification of Areafix
  478.     failures should be sent.  Such failures include nodes which are not
  479.     configured for areafix, nodes using incorrect areafix passwords, and
  480.     the like.  Setting this to 0 will disable this option.
  481.  
  482. Registration Number:
  483.     Upon registering SBBSecho with Digital Dynamics, you will be given a
  484.     registration number.  You should select this option and enter the
  485.     registration number you are given here.  If you have not yet registered
  486.     the program, this should say "Unregistered".
  487.  
  488. Nodes...
  489.     This option allows you to add, remove, and configure nodes that you
  490.     will be sending mail to.  Selecting this option will bring you to
  491.     a sub-menu which will look similar to the following:
  492.  
  493.                  ╔[■][?]══════╗
  494.                  ║    Nodes   ║
  495.                  ╠════════════╣
  496.                  ║ │ALL       ║
  497.                  ║ │1:100/ALL ║
  498.                  ║ │1:200/300 ║
  499.                  ║ │2:ALL     ║
  500.                  ║ │          ║
  501.                  ╚════════════╝
  502.  
  503.     At the Nodes... sub-menu, pressing the INSert key will allow you to
  504.     add a new node, pressing the DELete key will remove the currently
  505.     highlighted node number, and pressing ENTER on the currently
  506.     highlighted node will allow you to edit the options for that particular
  507.     node from a menu like the following (note that the node number you are
  508.     editing appears at the top of the window):
  509.  
  510.             ╔[■][?]════════════════════════════════╗
  511.             ║            1:200/300           ║
  512.             ╠══════════════════════════════════════╣
  513.             ║ │Address            1:200/300       ║
  514.             ║ │Archive Type        ZIP        ║
  515.             ║ │Packet Type        2+           ║
  516.             ║ │Packet Password               ║
  517.             ║ │Areafix Password            ║
  518.             ║ │Areafix Flags               ║
  519.             ║ │Status            None       ║
  520.             ║ │Direct            No           ║
  521.             ║ │Passive            No           ║
  522.             ║ │Send Notify List     No           ║
  523.             ╚══════════════════════════════════════╝
  524.  
  525.  
  526. _______________________________________________________________________________
  527. SBBSecho                              9                    Configuring SBBSecho
  528.  
  529.  
  530.     Address:
  531.         This is the address of the node you are editing, selecting it
  532.         will allow you to change this to a different address. Using
  533.         the "ALL" wildcard in place of one of the address components
  534.         will allow you to configure settings for all nodes that meet
  535.         that specication (e.g. all nodes in zone 1 can be specified
  536.         as 1:ALL or all nodes in zone 1, net 103 can be specified
  537.         as 1:103/ALL).
  538.  
  539.     Archive Type:
  540.         This is the compression type to be used when packing mail
  541.         bundles for this node.    Selecting this option will allow you
  542.         to choose from a menu of currently configured archive types,
  543.         like the following:
  544.  
  545.                    ╔[■][?]══════════╗
  546.                    ║  Archive Type    ║
  547.                    ╠════════════════╣
  548.                    ║ │ZIP        ║
  549.                    ║ │ARC        ║
  550.                    ║ │LZH        ║
  551.                    ║ │ARJ        ║
  552.                    ║ │PAK        ║
  553.                    ║ │SQZ        ║
  554.                    ║ │ZOO        ║
  555.                    ║ │None        ║
  556.                    ╚════════════════╝
  557.  
  558.         Selecting "None" will specify that this node is to receive
  559.         uncompressed packets (no bundles).
  560.  
  561.     Packet Type:
  562.         This is the packet type that will be used when creating mail
  563.         packets for this node. The default packet type used by SBBSecho
  564.         is 2+.    If you are a "point" address (e.g. 1:100/100.1) you
  565.         should use either a type 2+ or 2.2 packet since type 2 packets
  566.         do not support point numbers. Selecting this option will allow
  567.         you to choose from a menu of currently supported packet types:
  568.  
  569.                    ╔[■][?]═════════╗
  570.                    ║  Packet Type  ║
  571.                    ╠═══════════════╣
  572.                    ║ │2+           ║
  573.                    ║ │2.2           ║
  574.                    ║ │2           ║
  575.                    ╚═══════════════╝
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585. _______________________________________________________________________________
  586. SBBSecho                             10                    Configuring SBBSecho
  587.  
  588.  
  589.     Packet Password:
  590.         This is a password that will be placed into each outgoing mail
  591.         packet for this node.  Passwords are normally used for extra
  592.         security when sending and receiving mail packets.  This node
  593.         must also have the same packet password defined for your
  594.         address and SBBSecho must be set up for secure operation (set
  595.         in the 'Toggle Options' sub-menu) in order for this feature to
  596.         function properly.
  597.  
  598.     Areafix Password:
  599.         This is the password that will be required by this node (in
  600.         the subject field) when it sends messages to the area manager
  601.         (AreaFix).
  602.  
  603.     Areafix Flags:
  604.         When additional echo lists have been defined (from the
  605.         'Additional Echo Lists...' sub-menu) these flags determine
  606.         which echo lists can be used by this node when processing area
  607.         manager add requests.
  608.  
  609.     Status:
  610.         This option determines the netmail status that will be set
  611.         when SBBSecho sends out an areafix message or a file attach.
  612.         Selecting this option toggles between None, Crash, and Hold
  613.         status.
  614.  
  615.     Direct:
  616.         When set to 'Yes' this option will add a Direct kludge line
  617.         to messages that SBBSecho sends out (or create DLO/DUT files
  618.         for FLO mailers).
  619.  
  620.     Passive:
  621.         Setting this option to 'Yes' will prevent messages from being
  622.         sent to this node without the need for altering the AREAS.BBS
  623.         file.  This is useful for temporarily shutting off the messages
  624.         to this node.  This option can be toggled on and off remotely
  625.         via an area manager request.
  626.  
  627.     Send Notify List:
  628.                 This determines whether or not this node is sent a Notify List
  629.                 when using that command line option in SBBSecho.
  630.                 A Notify List is a netmail sent to the system operator of the
  631.                 node showing options set for the node as well as connected
  632.                 areas.
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644. _______________________________________________________________________________
  645. SBBSecho                             11                    Configuring SBBSecho
  646.  
  647.  
  648. Paths...
  649.     This option allows you to configure the paths and filenames which are
  650.     used by SBBSecho.  Selecting this option will bring you to the
  651.     following sub-menu:
  652.  
  653.       ╔[■][?]════════════════════════════════════════════════════╗
  654.       ║               Paths and Filenames             ║
  655.       ╠══════════════════════════════════════════════════════════╣
  656.       ║ │Inbound Directory            <Specified in SCFG>      ║
  657.       ║ │Secure Inbound (optional)        None Specified         ║
  658.       ║ │Outbound Directory         C:\IM\OUTBOUND\         ║
  659.       ║ │Area File                SCFG->DATA\AREAS.BBS     ║
  660.       ║ │Log File                SCFG->DATA\SBBSECHO.LOG  ║
  661.       ╚══════════════════════════════════════════════════════════╝
  662.  
  663.     Inbound Directory:
  664.         This is the directory where SBBSecho should look for inbound
  665.         mail packets.  This is normally taken from whatever has been
  666.         set in the SCFG program.
  667.  
  668.     Secure Inbound (optional):
  669.         This is an optional directory where SBBSecho should look for
  670.         secure inbound mail packets.
  671.  
  672.     Outbound Directory:
  673.         This is the directory where SBBSecho will place outgoing mail
  674.         packets and bundles.
  675.  
  676.     Area File:
  677.         This is the path and filename of the file that SBBSecho will
  678.         use as it's AREAS.BBS file.  By default SBBSecho looks for
  679.         the file AREAS.BBS in the data directory defined in SCFG.
  680.  
  681.     Log File:
  682.         This is the path and filename of the file that SBBSecho will
  683.         use when logging events.  By default SBBSecho uses the file
  684.         SBBSECHO.LOG in the data directory defined in SCFG.
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703. _______________________________________________________________________________
  704. SBBSecho                             12                    Configuring SBBSecho
  705.  
  706.  
  707. Log Options...
  708.     This list allows you to toggle what events SBBSecho should place into
  709.     the logfile.  Selecting this option will bring you to the following
  710.     sub-menu:
  711.  
  712.           ╔[■][?]═══════════════════════════════════╗
  713.           ║          Log Options            ║
  714.           ╠═════════════════════════════════════════╣
  715.           ║ │ALL                    ║
  716.           ║ │NONE                    ║
  717.           ║ │DEFAULT                    ║
  718.           ║ │Ignored NetMail Messages        No  ║
  719.           ║ │NetMail for Unknown Users        No  ║
  720.           ║ │Areafix NetMail Messages        Yes ║
  721.           ║ │Imported NetMail Messages        Yes ║
  722.           ║ │Packing Out-bound NetMail        Yes ║
  723.           ║ │Routing Out-bound NetMail        Yes ║
  724.           ║ │In-bound Packet Information    Yes ║
  725.           ║ │In-bound Security Violations    Yes ║
  726.           ║ │In-bound Grunged Messages        Yes ║
  727.           ║ │Disallowed Private EchoMail    Yes ║
  728.           ║ │Circular EchoMail Messages     No  ║
  729.           ║ │Duplicate EchoMail Messages    No  ║
  730.           ║ │Area Totals            Yes ║
  731.           ║ │Over-All Totals            Yes ║
  732.           ╚═════════════════════════════════════════╝
  733.  
  734.     Selecting ALL, NONE, or DEFAULT will toggle all of the options to
  735.     'Yes', 'No', or to their default states, respectively.
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762. _______________________________________________________________________________
  763. SBBSecho                             13                    Configuring SBBSecho
  764.  
  765.  
  766. Toggle Options...
  767.     These options allow you to toggle various features in SBBSecho.
  768.     Selecting this option will bring you to the following sub-menu:
  769.  
  770.        ╔[■][?]══════════════════════════════════════════════════╗
  771.        ║             Toggle Options             ║
  772.        ╠════════════════════════════════════════════════════════╣
  773.        ║ │Secure Operation                    Yes ║
  774.        ║ │Swap for Executables                Yes ║
  775.        ║ │Fuzzy Zone Operation                No  ║
  776.        ║ │Store PATH Lines in Message Base            Yes ║
  777.        ║ │Store SEEN-BY Lines in Message Base        Yes ║
  778.        ║ │Store Unknown Kludge Lines in Message Base    Yes ║
  779.        ║ │Allow Nodes to Add Areas in the AREAS.BBS List    Yes ║
  780.        ╚════════════════════════════════════════════════════════╝
  781.  
  782.     Secure Operation:
  783.         When set to 'Yes', SBBSecho will compare the origin of any
  784.         incoming mail packets to the nodes in the AREAS.BBS file
  785.         as messages are imported.  If a packet password has been
  786.         defined for that node, it will also be compared to the
  787.         password contained in the mail packet.    Packets and messages
  788.         failing this security will not be imported.
  789.  
  790.     Swap for Executables:
  791.         SBBSecho relies on external executable programs for extracting
  792.         and compressing mail bundles.  This option tells SBBSecho to
  793.         swap out of memory when running any of these executables,
  794.         giving the executable programs more free memory to run in.
  795.         This option is only used in the 16-bit DOS flavor of SBBSecho.
  796.  
  797.     Fuzzy Zone Operation:
  798.         Some mail programs do not create netmail messages with zone
  799.         information (INTL kludge line) or may only do so when sending
  800.         between zones. This is a problem for systems that receive
  801.         netmail for multiple addresses with different zones (AKAs with
  802.         different zone numbers). Setting this option to "Yes" allows
  803.         SBBSecho to guess what the correct originating and destination
  804.         zone is based on the net and node portions of the destination
  805.         address in netmail message.
  806.  
  807.     Store PATH Lines in Message Base:
  808.         When set to 'Yes', SBBSecho will store the PATH lines from
  809.         incoming echomail in the Synchronet message base headers (not
  810.         the body text). This option is useful for troubleshooting
  811.         routing/duplicate message problems.
  812.  
  813.     Store SEEN-BY Lines in Message Base:
  814.         When set to 'Yes', SBBSecho will store the SEEN-BY lines from
  815.         incoming echomail in the Synchronet message base headers (not
  816.         the body text).  This option is useful for troubleshooting
  817.         routing/duplicate message problems.
  818.  
  819.  
  820.  
  821. _______________________________________________________________________________
  822. SBBSecho                             14                    Configuring SBBSecho
  823.  
  824.  
  825.     Store Unknown Kludge Lines in Message Base:
  826.         When set to 'Yes', SBBSecho will store any unknown kludge lines
  827.         from incoming echomail in the Synchronet message base headers.
  828.         This option is useful for troubleshooting problems.
  829.  
  830.     Allow Nodes to Add Areas in the AREAS.BBS List:
  831.         When set to 'Yes', SBBSecho will allow nodes to add areas
  832.         (via area manager) which are listed in the AREAS.BBS list.
  833.         When set to 'No', SBBSecho will only allow nodes to add areas
  834.         from any additionally configured echo lists which they have
  835.         access to.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880. _______________________________________________________________________________
  881. SBBSecho                             15                    Configuring SBBSecho
  882.  
  883.  
  884. Archive Programs...
  885.     This option allows you to add or remove archive programs from SBBSecho.
  886.     Selecting this option will bring you to the following menu:
  887.  
  888.                  ╔[■][?]══════════════╗
  889.                  ║    Archive Programs  ║
  890.                  ╠════════════════════╣
  891.                  ║ │ZIP          ║
  892.                  ║ │ARC          ║
  893.                  ║ │LZH          ║
  894.                  ║ │ARJ          ║
  895.                  ║ │PAK          ║
  896.                  ║ │SQZ          ║
  897.                  ║ │ZOO          ║
  898.                  ║ │          ║
  899.                  ╚════════════════════╝
  900.  
  901.     At the Archive Programs... sub-menu, pressing the INSert key will allow
  902.     you to add a new archive program. Pressing the DELete key will remove
  903.     the currently highlighted archive program. And pressing ENTER on the
  904.     currently highlighted archive program will allow you to edit the
  905.     options for that particular prgram from a menu like the following (note
  906.     that the name of the archive program you are editing appears at the top
  907.     of the window):
  908.  
  909.       ╔[■][?]════════════════════════════════════════════════════╗
  910.       ║                   ZIP                 ║
  911.       ╠══════════════════════════════════════════════════════════╣
  912.       ║ │Packer Name      ZIP                     ║
  913.       ║ │Hexadecimal ID      504B                     ║
  914.       ║ │Offset to Hex ID      0                     ║
  915.       ║ │Pack Command Line      PKZIP %f %s                 ║
  916.       ║ │Unpack Command Line  PKUNZIP %f %s              ║
  917.       ╚══════════════════════════════════════════════════════════╝
  918.  
  919.     Packer Name:
  920.         This is the name that will be used to reference this particular
  921.         archiving program.  This is also the name that should be used
  922.         by nodes using areamanger to change their compression type
  923.         remotely.
  924.  
  925.     Hexadecimal ID:
  926.         This is a hexadecimal identifier that SBBSecho should look for
  927.         when determining the compression type used on incoming bundles.
  928.         In this example we are looking for the ID 'PK', '50' is the
  929.         hexadecimal value for the letter 'P' and '4B' is the
  930.         hexadecimal value for the letter 'K'.
  931.  
  932.     Offset to Hex ID:
  933.         This is the byte offset (from the beginning of the file) where
  934.         the hexadecimal ID for this archive program can be located.
  935.         In this example we are looking at an offset of 0 bytes from the
  936.         beginning of the file.
  937.  
  938.  
  939. _______________________________________________________________________________
  940. SBBSecho                             16                    Configuring SBBSecho
  941.  
  942.  
  943.     Pack Command Line:
  944.         This is the command line used by this archiving program for
  945.         compressing files.  The '%f' command line specifier will expand
  946.         to the name of the compressed file, the '%s' command line
  947.         specifier will expand to the name of the file being compressed.
  948.  
  949.     Unpack Command Line:
  950.         This is the command line used by the archiving program for
  951.         UNcompressing files.  The '%f' command line specifier will
  952.         expand to the name of the compressed file, the '%s' command
  953.         line specifier will expand to the path where the file is
  954.         being extracted to.
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998. _______________________________________________________________________________
  999. SBBSecho                             17                    Configuring SBBSecho
  1000.  
  1001.  
  1002. Additional Echo Lists...
  1003.     This option allows you to add and remove additional echo lists which
  1004.     can be used by SBBSecho for area manager add requests.    Normally these
  1005.     will be used in addition to your AREAS.BBS file.  If you have the
  1006.     toggle option 'Allow Nodes to Add Areas in the AREAS.BBS List' set to
  1007.     'No', you MUST create at least one additional echo list if you wish
  1008.     to allow other nodes to add areas via area manager requests.
  1009.  
  1010.     Selecting this option will bring you to a sub-menu listing any
  1011.     additional echo lists you currently have defined:
  1012.  
  1013.               ╔[■][?]═══════════════════╗
  1014.               ║  Additional Echo Lists  ║
  1015.               ╠═════════════════════════╣
  1016.               ║ │C:\BACKBONE\FIDONET.NA ║
  1017.               ║ │                ║
  1018.               ╚═════════════════════════╝
  1019.  
  1020.     Pressing the INSert key will allow you to add a new echo list, pressing
  1021.     the DELete key will remove the currently highlighted echo list, and
  1022.     pressing ENTER on the currently highlighted echo list will allow you to
  1023.     edit information about that list:
  1024.  
  1025.       ╔[■][?]════════════════════════════════════════════════════╗
  1026.       ║                Echo List                 ║
  1027.       ╠══════════════════════════════════════════════════════════╣
  1028.       ║ │Echo List Path/Name  C:\BACKBONE\FIDONET.NA         ║
  1029.       ║ │Hub Address      None                     ║
  1030.       ║ │Forward Password      None                     ║
  1031.       ║ │Forward Requests      No                     ║
  1032.       ║ │Echo List Flags      BACK                     ║
  1033.       ╚══════════════════════════════════════════════════════════╝
  1034.  
  1035.     Echo List Path/Name:
  1036.         This is the full path and filename of the echo list you are
  1037.         defining.  This list should contain the areatag names of areas,
  1038.         one per line, with any comments seperated from the areatag by
  1039.         at least one space.
  1040.  
  1041.     Hub Address:
  1042.         This is the address of the hub of the conferences contained
  1043.         in this list.  If an area is remotely added from this list
  1044.         (using Areafix) this address is automatically added to the
  1045.                 AREAS.BBS file.
  1046.  
  1047.     Forward Password:
  1048.         This is the area manager password to use when forwarding
  1049.         requests.
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057. _______________________________________________________________________________
  1058. SBBSecho                             18                    Configuring SBBSecho
  1059.  
  1060.  
  1061.     Forward Requests:
  1062.         Setting this option to 'Yes' will cause SBBSecho to send a
  1063.         request to the Hub Address specified to turn on an area from
  1064.         this list.  This happens when users remotely add areas using
  1065.         Areafix and is not necessary if you are already receiving the
  1066.         conferences in this list (ie: from Planet Connect).
  1067.  
  1068.  
  1069.     Echo List Flags:
  1070.         These are the flags required for a node to be able to gain
  1071.         access to this particular echo list.  These flags are defined
  1072.         for each node from the 'Nodes...' sub-menu.
  1073.  
  1074.         Selecting this option will bring you to a sub-menu where you
  1075.         may add and remove flags for this echo list.
  1076.  
  1077.                  ╔[■][?]═════════════╗
  1078.                  ║    Echo List Flags  ║
  1079.                  ╠═══════════════════╣
  1080.                  ║ │BACK         ║
  1081.                  ║ │         ║
  1082.                  ╚═══════════════════╝
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116. _______________________________________________________________________________
  1117. SBBSecho                             19                    Configuring SBBSecho
  1118.  
  1119.  
  1120. Running SBBSecho
  1121. ================
  1122.  
  1123. The command line for executing SBBSECHO is very similar to SBBSFIDO, although
  1124. some command line switches have been eliminated.
  1125.  
  1126. We suggest you use the following command lines:
  1127.  
  1128. For importing:
  1129.  
  1130.     C:\SBBS\EXEC\SBBSECHO /LES!
  1131.  
  1132. For exporting (Attach Mailer):
  1133.  
  1134.     C:\SBBS\EXEC\SBBSECHO /LIN
  1135.  
  1136. For exporting (FLO Mailer):
  1137.  
  1138.     C:\SBBS\EXEC\SBBSECHO /LINF
  1139.  
  1140. Remove all references to SBBSFIDO from your batch files (if you have any).
  1141. See the included MAILER.BAT as an example.
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175. _______________________________________________________________________________
  1176. SBBSecho                             20                        Running SBBSecho
  1177.  
  1178.  
  1179. Command Lines Switches
  1180. ======================
  1181.  
  1182. usage: sbbsecho [cfg_file] [/switches] [sub_code]
  1183.  
  1184. where: cfg_file is the filename of config file (default is ctrl\sbbsecho.cfg)
  1185.        sub_code is the internal code for a sub-board (default is ALL subs)
  1186.  
  1187. SBBSecho will execute normally (for Attach Mailer operation) with NO command
  1188. line switches required. Command lines switches are used to cause SBBSecho to
  1189. _do_ or _not_ do specific operations. When used, command line switches
  1190. are prepended by a slash (/) character. Multiple switches can be specified
  1191. in one grouping (multiple /switch sets are supported, but not required).
  1192. Switch letters are not case sensitive. The available switch letters and their
  1193. descriptions are:
  1194.  
  1195. P: Do not import inbound packets or extract inbound bundles
  1196. X: Do not delete inbound packets (*.PKT) after they're imported
  1197. N: Do not import inbound netmail (packetized netmail and *.MSG)
  1198. D: Do not delete inbound netmail (*.MSG) after they're imported
  1199. I: Do not import inbound echomail
  1200. E: Do not export outbound echomail
  1201. M: Ignore echomail pointers (export all locally created echomail messages)
  1202. U: Update echomail pointers only (export no echomail messages)
  1203. T: Do not update echomail pointers (test export)
  1204. H: Export all echomail messages (including messages imported from FidoNet)
  1205. J: Ignore recieved bit on netmail (import even though flagged as received)
  1206. L: Create log file (data\sbbsecho.log)
  1207. R: Create report of import totals (text\sbbsecho.msg)
  1208. B: Import locally created netmail too (ignore the local flag)
  1209. A: Export ASCII characters only (override individual sub-board ex-ASCII strip)
  1210. F: Create packets for outbound netmail (necessary for FLO Mailer operation)
  1211. G: Generate notify lists
  1212. Y: Import netmail for unknown users to sysop (user #1)
  1213. O: Import all netmail regardless of destination address (unless flagged local)
  1214. S: Import private echomail override (strip private flag)
  1215. =: Change existing tear lines to === when exporting
  1216. !: Notify users via telegram of received echomail messages
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234. _______________________________________________________________________________
  1235. SBBSecho                             21                  Command Lines Switches
  1236.  
  1237.  
  1238. AREAFIX Commands
  1239. ================
  1240.  
  1241. Remote area manager, or areafix, commands are used by uplinks to be able to
  1242. turn echo areas off and on, list currently connected areas, and more.
  1243.  
  1244. The following text is from the file AREAMGR.HLP which, after installation of
  1245. SBBSecho, should be located in your Synchronet EXEC directory.    It lists the
  1246. area manager commands available to the nodes which have been configured using
  1247. the ECHOCFG program:
  1248.  
  1249. Address all requests to 'SBBSecho' or 'AreaFix' (without quotes).
  1250. Your Area Manager password goes on the subject line.
  1251.  
  1252. In the body of the message to Area Manager:
  1253.  
  1254. [+]<areaname>         Connect an area
  1255. -<areaname>           Disconnect an area
  1256. %HELP                 Request this message
  1257. %LIST                 Request a list of areas available to you
  1258. %QUERY                Request a list of areas to which you are connected
  1259. %UNLINKED             Request a list of areas to which you are not connected
  1260. %COMPRESSION <type>   Change the compression type (ARC/ARJ/LZH/PAK/SQZ/ZIP/ZOO)
  1261. %PASSWORD <password>  Change your AreaMgr password
  1262. %RESCAN           Request a rescan of newly added areas
  1263. %ACTIVE           Reconnect all temporarily disconnected areas
  1264. %PASSIVE          Temporarily disconnect all connected areas
  1265. %FROM <address>       Remote maintenance, must be the first command
  1266. %+ALL              Connect all available areas
  1267. %-ALL              Disconnect all areas
  1268. [---]                 Everything below the tear line is ignored
  1269.  
  1270. NOTE: A compression type of NONE is also supported for uncompressed packets.
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293. _______________________________________________________________________________
  1294. SBBSecho                             22                        Areafix Commands
  1295.  
  1296.  
  1297.  
  1298.